Repository navigation
Conversation
识别和 AI 润色都没有改对的错误(「Qwen 4 max」识别成「Quinn for max」), 学习建议以前学不到:它只比较识别原文和润色结果。现在用户在应用里改正后, 选中改好的文字按「从选中文字学习」的快捷键(默认未设置),Voltip 用复制键 读出选区,在最近 50 次听写里找到它改正的记录,把改后的文字存进这条历史 记录,改动作为「你的修改」进学习建议;悬浮窗显示记下的改动,可以一键加入 词典、撤销、查看。全程只逐字比较,不调用 AI(docs/dictation.md §35)。 - 核心:Settings.learn_hotkey 与四个组合键互斥;CoreCommand::LearnSelection 与 runtime/learn.rs;vocabulary/learn.rs 的匹配与可学的改动; HistoryEntry.corrected 与 set_corrected;UiState.learn_notice 的排队与计时。 - 学习建议:第二个来源(from_edits、edited),「推荐」包含只出现 1 次的修改; 中文单字的改动带上相邻的字(「非书 → 飞书」不再汇总为「非 → 飞」), MCP 的 vocabulary_candidates 同样。 - 桌面:快捷键注册(X11 松开后触发)、--learn-selection、悬浮窗的 learned 状态、open_suggestions / open_privacy、设置页的快捷键行、历史详情的 「之后改成」与移除。 - 真机测试:X11 的两个选区复制测试接入 CI;记事本与 TextEdit 的复制检查; Linux 冒烟测试走一遍完整流程。 - 文档:dictation §35、§16.10、§25.4,验收清单,威胁模型,站点中英文页面 与学习建议截图。
Codecov Report❌ Patch coverage is @@ Coverage Diff @@
## main #260 +/- ##
==========================================
- Coverage 93.58% 93.52% -0.07%
==========================================
Files 489 491 +2
Lines 85908 87381 +1473
Branches 4909 5011 +102
==========================================
+ Hits 80398 81722 +1324
- Misses 4841 4962 +121
- Partials 669 697 +28
Flags with carried forward coverage won't be shown. Click here to find out more.
... and 7 files with indirect coverage changes 🚀 New features to boost your workflow:
|
- macOS 的终端里同样不复制、不学习:学习改用包括 macOS 终端的表 (insert_check::holds_program_output),语音编辑的表在 macOS 上是空的。 - 选区复制一次只做一次:从保存到放回剪贴板持有进程锁,连按两次快捷键或 学习与语音编辑同时复制时,不会把用户的剪贴板读成选区或弄丢。 - 已改正过的记录同时与改后的文字和插入的文字比较;改后的文字与选区没有 相同的词时,以插入的文字为基准(选中原文撤回整处修改)。 - 修改来源的 via 增加 follow(以后的实验功能写入),这个版本能读取。 - 学习建议:用户修改每条记录每组只算 1 次;跳过的带修改记录也计入 edited;只有修改、没有新写法时,空状态按比较过的记录写。 - 「查看」「打开设置」也让通知重新停留 8 秒(learn_notice_keep)。 - 「已忽略」的表头改为「识别结果 → 正确写法」。
已改正过的记录与改后的文字、插入的文字都对齐时,用相似度更高(一样高时 覆盖选区更多)的那个重建;胜出的是插入的文字时,把对齐的范围对到改后的 文字里替换,范围以外的旧修改照样保留。选区在下一个词之前结束时,保留原来 那里的空格(以前会拼成「Qwen 4 maxis great」)。
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
目标
测试用户反馈(2026-11-18):识别和 AI 润色都没有改对的错误,学习建议学不到。说「Qwen 4 max」,识别和润色都写成「Quinn for max」,用户在应用里改正了,Voltip 不知道。
这个 PR 是计划「从修改中学习」的第一部分:从选中文字学习(用户决定 2026-11-18,D1–D5 已逐项确认)。实验功能「跟踪输入框里的修改」是第二部分,先在用户的电脑上实测各应用的输入框能不能读到,再单独出计划。手机端不做。不发版。
用户能看到的变化(电脑)
voltip-desktop --learn-selection。改动
voltip-core):Settings.learn_hotkey与四方互斥;CoreCommand::LearnSelection与runtime/learn.rs(探针 → 终端不按键 → 复制选区 → 最近 50 条听写 → 保存修改 → 计算组合 → 通知);vocabulary/learn.rs(对齐、相似度、选记录、可学的改动);HistoryEntry.corrected、HistoryStore::set_corrected、recent_texts带出修改、搜索文本;学习建议的第二个来源(from_edits、edited、edit_picks);mcp::candidates的单字扩展(scan/widen/Replay);UiState.learn_notice的排队与计时(结果卡片在时排队,新听写开始时清掉,悬浮窗关闭时不建通知)。--learn-selection、悬浮窗的learned状态、open_suggestions、open_privacy、history_clear_corrected。docs/dictation.md新增 §35,改写 §16.10、§25.4;docs/acceptance.md、docs/threat-model.md;站点中英文的词典、快捷键、隐私页;重拍dictionary-suggestions-{zh,en}-light.webp(mock 的示例记录加了两条带修改的听写,截图里能看到两种来源)。smoke-desktop加装python3-tk,跑 X11 的两个选区复制测试;冒烟脚本走一遍从选中文字学习。与计划不同的地方
focus_windows.rs/focus_macos.rs,没有在 voltip-inject 下新建selection_windows.rs/selection_macos.rs:那两个测试已经会打开记事本和 TextEdit,CI 已经给 macOS 的测试二进制授予辅助功能权限,跑在同一步里。open_privacy:计划写的是沿用学习建议页的按钮,但悬浮窗不能让主窗口换页,做法与「查看」的open_suggestions相同。regression_an_end_replacement_with_nothing_in_common_keeps_every_character,修复前按冒烟日志的方式失败)。§35.4 写明了这条规则。改了期望的已有测试
settings::tests::regression_the_smoke_scripts_write_the_current_settings_schema:smoke-dictation.sh的设置模板多了可选的learn_hotkey,测试加上这个占位的替换。规则(冒烟脚本写的是当前的设置格式)不变,现在也检查learn_hotkey这个键。mock-backend.test.ts「the sample takes for screenshots …」:截图用的示例记录多了两条带修改的听写,次数随之改变;测试仍检查有出现 2 次及以上和只出现 1 次的建议,并新增检查「你的修改」。测试
make verify在 b5f9314 上通过(dirty_paths=0,rustc 1.98.0):Rust 过滤后的行覆盖率 92.91%(门槛 90%),桌面前端 97.5%,手机 97.69%,其余门禁全部 exit 0。另外单独跑了
cargo test --workspace --all-targets --no-fail-fast与各前端包的全部测试,均通过。真机:
scripts/smoke-desktop-linux.sh本机通过(日志learn selection outcome="learned",history.sqlite3里那条记录的corrected是选中的文字,剪贴板放回哨兵内容,悬浮窗显示通知)。hooks-windows)与 macOS(macos的 Apple 芯片一路)的复制检查只能在 CI 上跑;macOS 合并前用gh workflow run ci.yml --ref feat/learn-from-selection触发。Windows 测试已用cargo xwin clippy -D warnings编译检查。不需要
make refine-eval:提示词和预设都没改。